home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / PRINTER / SPOOL / !Spool / !Help next >
Text File  |  1995-11-07  |  9KB  |  258 lines
  1. Instructions for !Spool by Andrew Sellors
  2.  
  3. *****************************************************************************
  4. * NOTE:                                                                     *
  5. * !Spool is FreeWare.                                                       *
  6. * This means that you may freely copy and distribute it, provided that it   *
  7. * is complete with all original files, and that you do not sell it.         *
  8. * PD libraries may charge a nominal fee for the cost of duplication,        *
  9. * postage etc.                                                              *
  10. * In no circumstances shall the author be liable for any damage, loss of    *
  11. * profits, time or data or any indirect or consequential loss rising out of *
  12. * the use of this software or inability to use this software.               *
  13. *****************************************************************************
  14.  
  15. Contents:
  16. ---------
  17.  
  18. Aims
  19. Features
  20. Before you start!
  21. Compatibility
  22. Operation
  23. Iconbar menu
  24. "Spool Configuration" window
  25. "Sending File" window
  26. Buffers
  27. Setting the 3D bit
  28. Contacting the author
  29.  
  30. ********************************************************************************
  31.  
  32. Aims:
  33. -----
  34.  
  35. This program spools files in the background in the Desktop to either the serial
  36. or parallel ports.
  37.  
  38. ********************************************************************************
  39.  
  40. Features:
  41. ---------
  42.  
  43. Uses 3D bit in CMOS RAM to select 2D or 3D windows _and_ iconsprites on startup.
  44. (See the "Setting the 3D bit" section if you don't like 2D windows)
  45.  
  46. Uses Block Drivers so it can use serial ports other than the internal one.
  47.  
  48. Provides full control over the serial port used.
  49.  
  50. Can send a sequence of files one after another.
  51.  
  52. Has the option of mapping the printer data so that a TurboDriver printer cable
  53. can be used.
  54.  
  55. ********************************************************************************
  56.  
  57. Before you start!:
  58. ------------------
  59.  
  60. Before you can use this program you need the Block Drivers by Hugo Fiennes.
  61. If you don't have them then download them now! or look at your favourite
  62. PD library.
  63.  
  64. ********************************************************************************
  65.  
  66. Compatibility:
  67. --------------
  68.  
  69. This program is for RISC OS 3.10 or later.
  70. It has been tested on both RISC OS 3.10 and RISC OS 3.50 and with the internal
  71. port using Block Drivers v10a.
  72.  
  73. ********************************************************************************
  74.  
  75. Operation:
  76. ----------
  77.  
  78. When the !Spool icon is double-clicked, it installs itself on the left of the
  79. icon bar with the configured Block Driver loaded. If the !SerialDev application
  80. that holds the Block Drivers has not been seen by the Filer then an error is
  81. reported and the program does not start up.
  82.  
  83. Dragging a file to the icon will cause it to be sent to the selected destination
  84. and a status window showing the progress displayed.
  85.  
  86. Dragging a file to the icon when a file is already sending causes it to be
  87. queued, the total number of files shown in the status window will increase.
  88.  
  89. Dragging a selection of files to the icon will result in all the files being
  90. sent to the selected destination port in sequence.
  91.  
  92. ********************************************************************************
  93.  
  94. Iconbar menu:
  95. -------------
  96.  
  97.    +--------------+
  98.    |    Spool     |
  99.    +--------------+
  100.    | Info    ⇨    | ⇨ opens "About this program" window
  101.    | Configure... | Opens "Spool Configuration" window
  102.    | Quit         | Quits program.
  103.    +--------------+
  104.  
  105. ********************************************************************************
  106.  
  107. "Spool Configuration" window:
  108. -----------------------------
  109.  
  110. This allows the serial port, destination of the file and filebuffer size to be
  111. setup.
  112.  
  113. Any changes made only take effect when either "Change" or "Save" are selected.
  114.  
  115.  
  116. "Serial Port" group:
  117.  
  118. The "Driver Name" pop-up menu allows you to change the Block Driver used.
  119. When a new driver is selected, the driver is scanned to find the baud rates
  120. and ports supported, and the relevant menus changed accordingly.
  121.  
  122. Clicking on "Rescan Drivers" rechecks the available Block Drivers and updates
  123. the list of drivers for the "Driver Name" menu. This can be used to update
  124. the list if any drivers have been added since the program was started.
  125.  
  126. The "Port Number" pop-up menu allows the serial port to be configured as
  127. some drivers support more than one serial port, the internal driver has only
  128. one port: 0.
  129.  
  130. The other menus are fairly self explanatory, these should be set to the same
  131. as the device that is connected to the serial port.
  132.  
  133.  
  134. "Destination" group:
  135.  
  136. This allows the destination of the file to be selected between either the
  137. serial or parallel ports.
  138. When !Spool cannot claim the parallel port for use, the icon will be greyed
  139. out.
  140.  
  141.  
  142. "Transfer" group:
  143.  
  144. The "Buffer Size" writeable icon allows the size of the filebuffer to be
  145. changed. This is the amount of memory that is claimed when a transfer is
  146. initiated (and released when finished) to be used to buffer the disc access.
  147. The file being transferred is read in chunks of the buffer size, so a larger
  148. size will reduce the disc access at the expense of more memory being used
  149. at transfer time.
  150.  
  151. Turning on the "TurboDriver Cable" option allows Spool to be used when the
  152. special cable for the CC TurboDrivers is being used. If you have a normal cable
  153. and select this option then the printer will print garbage.
  154.  
  155.  
  156. Clicking on "Change" makes any changes made take effect and removes the window
  157. from the screen. If adjust is used instead of select then the window is left
  158. on screen.
  159.  
  160. Clicking on "Cancel" throws away any changes made and removes the window from
  161. the screen.
  162.  
  163. Clicking on "Save" makes any changes made take effect and the saves the
  164. configuration to disc to be used the next time the program is loaded. If
  165. adjust is used instead of select then the window is left on screen.
  166.  
  167. ********************************************************************************
  168.  
  169. "Sending File" window:
  170. ----------------------
  171.  
  172. This window is displayed in the bottom left corner of the screen when a file
  173. is being sent. It shows the filename of the current file being sent, the amount
  174. of data transferred so far and the total amount of data for that particular
  175. file. It also shows the total number of files in the queue and the number of
  176. the current file being sent. The bar marked 'progress' indicates graphically
  177. how much of the current file has been sent.
  178.  
  179. The "Abort" icon stops all sending operations.
  180.  
  181. The "Skip" icon stops the current file from being sent and moves the program on
  182. to the next file in the queue if there is one. 
  183.  
  184. ********************************************************************************
  185.  
  186. Buffers:
  187. --------
  188.  
  189. Increasing the size of the printer buffer from its default size of 1K will
  190. improve the speed at which data is sent to the parallel port, and so reduce
  191. printing time.
  192.  
  193. The size of the printer buffer is shown by:
  194. *Status PrinterBufferSize
  195.  
  196. I recommend a size of at least 16K which is achieved by
  197. *Configure PrinterBufferSize 16K
  198.  
  199. Note: This amount is actually allocated in units of pages of memory so
  200. depending on the type of machine and the amount of memory fitted the value
  201. actually allocated could be higher.
  202.  
  203.  
  204. Increasing the size of the serial output buffer also increases the speed at
  205. which data can be sent to the serial port as the normal buffer is very small,
  206. only 191 bytes. This can be done by loading a module such as SerialBuff by
  207. David Pilling.
  208.  
  209. ********************************************************************************
  210.  
  211. Setting the 3D bit:
  212. -------------------
  213.  
  214. If you want to use the 3D windows in this program (and the handful of others
  215. that support it) then you need to set the 3D bit in the CMOS RAM. In RISC OS 
  216. there is no *configure command to change it.
  217.  
  218.    Cut out the following BASIC program and run it.
  219.    Note: this program toggles the bit, so if its off and you run it twice then
  220.          it is still off!
  221.  
  222.     10REM Toggle state of '3D look' bit in CMOS
  223.     20REM Read byte
  224.     30SYS "OS_Byte",161,140 TO ,,byte%
  225.     40REM EOR byte with mask for bit 0
  226.     50byte% = byte% EOR 1
  227.     60REM Write byte back again
  228.     70SYS "OS_Byte",162,140,byte%
  229.     80END
  230.  
  231.     OR
  232.  
  233.     If you have RISC OS 3.5+ then it will probably be on, otherwise you will
  234.     have to then turn off "2D window tools" in the "Window Manager" part of
  235.     !Configure.
  236.     
  237. ********************************************************************************
  238.  
  239. Contacting the author
  240. --------------------
  241.  
  242. I, Andrew Sellors, can be contacted either at
  243.    57 Boundaries Road
  244.    Feltham
  245.    Middlesex
  246.    TW13 5DR
  247.    England
  248.  
  249. Or via Internet email at
  250.    asellors@orac2.demon.co.uk
  251.  
  252. Any feedback from users (bugs reports, requests for new features, praise,
  253. money etc.) is gladly received. 
  254.  
  255.  
  256.  
  257.  
  258.